
<!DOCTYPE html>
<html class="client-nojs" lang="en" dir="ltr">
<head>
<meta charset="UTF-8"/>
<title>Align image stack - PanoTools.org Wiki</title>




<style media="screen" type="text/css" title="Screen style sheet"> @import url(manual.css); </style>

<meta name="generator" content="MediaWiki 1.35.3"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>





<!--[if lt IE 9]><![endif]-->
</head>
<body class="mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-0 ns-subject page-Align_image_stack rootpage-Align_image_stack skin-vector action-view skin-vector-legacy">


<div id="content" class="mw-body" role="main">
	<a id="top"></a>
	
	
	<h1 id="firstHeading" class="firstHeading" lang="en">Align image stack</h1>
	<div id="bodyContent" class="mw-body-content">
		<div id="siteSub" class="noprint">From PanoTools.org Wiki</div>
		
		
		
		
		
		
		<div id="mw-content-text" lang="en" dir="ltr" class="mw-content-ltr"><div class="mw-parser-output"><p>align_image_stack is a command-line tool to align overlapping images to facilitate <a href="HDR.html" title="HDR">HDR</a> creation, Exposure blending<a class="external" href="https://wiki.panotools.org/Exposure_blending">[*]</a>, extended <a href="Depth_of_Field.html" title="Depth of Field">Depth of Field</a>, and Stereoscopic<a class="external" href="https://wiki.panotools.org/index.php?title=Stereoscopic&amp;action=edit&amp;redlink=1">[*]</a> images.
</p>
<h2><a name="Usage"><span class="mw-headline">Usage</span></a></h2>
<pre>align_image_stack [options] input_files
</pre>
<h3><a name="Options:_modes_of_operation"><span class="mw-headline">Options: modes of operation</span></a></h3>
<pre>-p file   
</pre>
<p>Output .pto file. (Useful for debugging, or further refinement.)
</p>
<pre>-a prefix 
</pre>
<p>Align images, output as prefix_xxxx.tif.
</p>
<pre>-o output 
</pre>
<p>Merge images to HDR, generate output.hdr.
</p>
<h3><a name="Options:_modifiers"><span class="mw-headline">Options: modifiers</span></a></h3>
<pre>-v        
</pre>
<p>Verbose, print progress messages.
</p>
<pre>-e
</pre>
<p>Assume input images are full frame <a href="Fisheye_Projection.html" title="Fisheye Projection">fish eye</a> (default: <a href="Rectilinear_Projection.html" title="Rectilinear Projection">rectilinear</a>).
</p>
<pre>-t num    
</pre>
<p>Remove all control points with an error higher than num pixels (default: 3).
</p>
<pre>--corr=num
</pre>
<p>Correlation threshold for identifying control points (default: 0.9).
</p>
<pre>-f HFOV   
</pre>
<p>Approximate horizontal field of view<a class="external" href="https://wiki.panotools.org/Field_of_view">[*]</a> of input images. Use if <a href="EXIF.html" title="EXIF">EXIF</a> info not complete.
</p>
<pre>-m        
</pre>
<p>Optimize field of view for all images, except for first. Useful for aligning focus stacks with slightly different magnification.
</p>
<pre>-d
</pre>
<p>Optimize radial distortion for all images, except for first.
</p>
<pre>-i
</pre>
<p>Optimize image center shift for all images, except for first.
</p>
<pre>-x
</pre>
<p>Optimize X coordinate of the camera position.
</p>
<pre>-y
</pre>
<p>Optimize Y coordinate of the camera position.
</p>
<pre>-z
</pre>
<p>Optimize Z coordinate of the camera position. Useful for aligning more distorted images.
</p>
<pre>-S
</pre>
<p>Assume stereo images - allow horizontal shift of control points.  Adds all control points as "horizontal lines".
</p>
<pre>-A
</pre>
<p>Align stereo window - assumes -S.  Adds one "normal" control point that is the nearest point, so that everything will appear behind the display plane.
</p>
<pre>-P
</pre>
<p>Align stereo window with pop-out effect - assumes -S.  Adds one "normal" control point that is the nearest point from the border areas, so that the center of the image may appear in front of the display plane.
</p>
<pre>-C
</pre>
<p>Auto crop the image to the area covered by all images.
</p>
<pre>-c num    
</pre>
<p>Number of <a href="Control_points.html" title="Control points">control points</a> (per grid, see option -g) to create between adjacent images (default: 8).
</p>
<pre>-l
</pre>
<p>Assume linear input files.
</p>
<pre>-s scale
</pre>
<p>Scale down image by 2<sup>scale</sup> (default: 1 [2x downsampling]). Scaling down images will improve speed at the cost of accuracy.
</p>
<pre>-g gsize
</pre>
<p>Break image into a rectangular grid (gsize x gsize) and attempt to find num control points in each section (default: 5 [5x5 grid] )
</p>
<pre>--distortion
</pre>
<p>Try to load distortion information from lens database.
</p>
<pre>--use-given-order  
</pre>
<p>Use the image order as given from command line. (By default images will be sorted by exposure values as found in EXIF data.)
</p>
<pre>--gpu     
</pre>
<p>Use GPU for remapping.
</p>
<pre>-h        
</pre>
<p>Display help.
</p>
<div class="usermessage" id="stub">
<table cellpadding="0" cellspacing="0" style="background-color:inherit">
<tbody><tr>
<td><i>This article is incomplete.  You can help Panotools Wiki by <a rel="nofollow" class="external text" href="https://wiki.panotools.org/index.php?title=Align_image_stack&amp;action=edit">expanding it</a>.</i>
</td></tr></tbody></table>
<p><span style="font-weight:normal;">
<small>Once the article is ok feel free to remove the {{Incomplete}} template</small>
</span></p><p class="mw-empty-elt">
</p>
</div>

<!--
Transclusion expansion time report (%,ms,calls,template)
100.00%   28.836      1 Template:Incomplete
100.00%   28.836      1 -total
 47.46%   13.686      1 Template:Enhance
-->


</div></div><div class="printfooter">Retrieved from "<a dir="ltr" href="https://wiki.panotools.org/index.php?title=Align_image_stack&amp;oldid=15916">https://wiki.panotools.org/index.php?title=Align_image_stack&amp;oldid=15916</a>"</div>
		</div></div></body></html>